home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 011 / filepc.arc / FILE-PC.DOC next >
Encoding:
Text File  |  1985-06-19  |  46.0 KB  |  1,091 lines

  1.  
  2.  
  3.  
  4.  
  5.                                                tm
  6.         ======================= F R E E W A R E =======================
  7.  
  8.                             User-Supported Software
  9.             If you are using this program and find it to be of value
  10.                    your $25 contribution will be appreciated.
  11.  
  12.                                    Jim Button
  13.                                    P.O. Box 5786
  14.                                    Bellevue, WA  98006
  15.  
  16.                  Regardless of whether you make a contribution,
  17.                you are encouraged to copy and share this program.
  18.  
  19.                ---------------------------------------------------
  20.  
  21.         FREEWARE user-supported software is an experiment in distributing 
  22.         computer programs, based on three principles:
  23.  
  24.         First, that the value and utility of software is best assessed by 
  25.         the  user on his/her own system.  Only after using a program  can 
  26.         one  really  determine whether it serves  personal  applications, 
  27.         needs, and tastes.
  28.  
  29.         Second,  that  the  creation  of  independent  personal  computer 
  30.         software can and should be supported by the computing community.
  31.  
  32.         Finally,  that  copying  and  networking of  programs  should  be 
  33.         encouraged,  rather than restricted. The ease with which software 
  34.         can   be  distributed  outside  traditional  commercial  channels 
  35.         reflects the strength,  rather than the weakness,  of  electronic 
  36.         information.
  37.  
  38.  
  39.         The user-supported concept:
  40.  
  41.         Anyone  may request a copy of a user-supported program by sending 
  42.         a  blank,  formatted  disk  to the  author  of  the  program.  An 
  43.         addressed, postage-paid return mailer must accompany the disk (no 
  44.         exceptions, please).
  45.  
  46.         A copy of the program, with documentation, will be sent by return 
  47.         mail.  The  program will carry a notice suggesting a contribution 
  48.         to  the  program's author.  Making a contribution  is  completely 
  49.         voluntary on the part of the user.
  50.  
  51.         Regardless  of  whether  a contribution  is  made,  the  user  is 
  52.         encouraged  to  share  the program  with  others.  User-supported 
  53.         programs  are  not copyrighted or licensed.  Payment for  use  is 
  54.         discretionary on the part of each subsequent user.
  55.  
  56.         Will it really work?
  57.  
  58.         Up  to  now,  distribution  of  software  has  relied  either  on 
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.         restricting  access (and charging for the cost of doing  so),  or 
  71.         anonymously  casting programs into the public domain.  The  user-
  72.         supported  concept  might  -- just  might -- be  a  way  for  the 
  73.         computing  community  to  support  and  encourage  creative  work 
  74.         outside the traditional marketplace.
  75.  
  76.         This  is  an experiment in economics  more  than  altruism.  Free 
  77.         distribution  of software and voluntary payment for its use would 
  78.         eliminate   the  need  for  money  to  be  spent  on   marketing, 
  79.         advertising,  and  copy protection schemes.  Users  could  obtain 
  80.         quality software at reduced cost,  while still supporting program 
  81.         authors. And the most useful programs would survive, based purely 
  82.         on their usefuness.
  83.  
  84.         Please join the experiment.
  85.  
  86.         FREEWARE  is  the trademark of The Headlands Press for its  user-
  87.         supported software,  but we are inviting all software authors  to 
  88.         participate in this distribution concept.
  89.  
  90.         FREEWARE  is publishing a  CATALOG of user-supported software  by 
  91.         program  authors  everywhere who are willing to make  their  work 
  92.         available on a free, non-restricted basis. If you would like your 
  93.         program listed,  please send a description of the program and the 
  94.         address to which requests for copies should be  sent.  Fulfilling 
  95.         requests and suggesting contributions are the sole responsibility 
  96.         of the program author. Listings in the catalog are free.
  97.  
  98.         Our own programs are designed to run on the IBM Personal Computer 
  99.         but  we  will include software for any computer in  the  Freeware 
  100.         Catalog. (Please specify system requirements.)
  101.  
  102.         We  welcome  your comments about the user-supported  concept  and 
  103.         about any of our programs.
  104.  
  105.         Andrew Fluegelman
  106.         The Headlands Press, Inc.
  107.         Post Office Box 862
  108.         Tiburon, California 94920
  109.  
  110.         CompuServe 71435,1235
  111.         Source TCP204
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.                                      PC-FILE
  145.  
  146.  
  147.                            A Database Manager Program
  148.                           For the IBM Personal Computer
  149.  
  150.                               (1982) by Jim Button
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.         Jim Button
  186.         P.O. Box 5786
  187.         Bellevue, WA 98006
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                                      PC-FILE
  203.                                 Table of Contents
  204.  
  205.  
  206.         General Information........................................2
  207.  
  208.         Getting started............................................3
  209.  
  210.         Defining your file.........................................3
  211.  
  212.         The Master Menu screen.....................................4
  213.  
  214.         Adding Records to your Database............................5
  215.  
  216.         Modifying a Record.........................................5
  217.  
  218.         Deleting a Record..........................................6
  219.  
  220.         Displaying a Record (by using the 'key')...................6
  221.  
  222.         Finding a Record...........................................6
  223.  
  224.         Listing the Records........................................7
  225.  
  226.         Sorting the Database Index.................................8
  227.  
  228.         Seeing the Record Layout...................................9
  229.  
  230.         Altering a Field Name.....................................10
  231.  
  232.         Ending the program........................................10
  233.  
  234.         Backing up the Database...................................10
  235.  
  236.         Using other printers......................................10
  237.  
  238.         Using 40-character width displays.........................11
  239.  
  240.         Using the PC-File Data With Other Programs................11
  241.  
  242.         Importing Other Files into PC-File........................12
  243.  
  244.         Compatibility With Prior Versions.........................12
  245.  
  246.         Some Maximums and Minimums................................12
  247.  
  248.         Calculating the Size of Database Disk Storage.............12
  249.  
  250.         A Note For Users With Only 1 Disk Drive...................13
  251.  
  252.         Disclaimer................................................13
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.                                         1
  260.  
  261.  
  262.  
  263.  
  264.  
  265.         PC-FILE                   USER'S GUIDE                   Page  2.
  266.  
  267.  
  268.  
  269.         GENERAL INFORMATION:
  270.              PC-File is a general purpose "Data Base Manager" program. It 
  271.         was written with one overriding goal in mind:  Ease of use.  With 
  272.         PC-File,  its  very easy for the casual or professional  user  to 
  273.         create  and  maintain data files on the computer,  and to  create 
  274.         simple printed reports based on that data.
  275.              You can use PC-File for all kinds of tasks:
  276.                   Maintain mailing lists and print labels,
  277.                   Maintain price lists,
  278.                   Maintain telephone directories,
  279.                   Keep various types of inventory lists,
  280.                   Build recipe files,
  281.                   Build and maintain files to be used by other programs,
  282.                   and many other tasks which only you can dream up.
  283.  
  284.              PC-File  will  allow  you to sort your data into almost  any 
  285.         sequence.  It allows rapid access to any record in the file, with 
  286.         a  sophisticated search technique allowing comparison searches on 
  287.         any  field  in  the record.  For example,  you  can  display  all 
  288.         employees over a certain age,  or all clients in a certain state, 
  289.         or  all items that are not in a certain category.  You can  print 
  290.         out  reports  from  your database,  listing all or  some  of  the 
  291.         fields,  from  all  or  some of the records,  in  many  different 
  292.         sequences, with totals on the numeric fields. Reports can be sent 
  293.         directly  to your video screen,  or to any one of many  different 
  294.         types of printers.
  295.  
  296.              But above all else,  PC-File is EASY! Most people can use it 
  297.         with  no training or instructions whatsoever.  You need read  the 
  298.         documentation  only  to pick up some extra 'fine points'  of  the 
  299.         program. The author has steadfastly refused to make any additions 
  300.         to  PC-File  which would make it harder to use.  Any  suggestions 
  301.         which  you  have  for  improving this  program  will  be  greatly 
  302.         appreciated.
  303.  
  304.              PC-File requires a 64K or larger IBM Personal Computer, with 
  305.         at  least one disk drive.  A printer is optional.  PC-File can be 
  306.         set  up  to  support either 40 character  or  80  character  wide 
  307.         displays. 
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.                                         2
  326.  
  327.  
  328.  
  329.  
  330.  
  331.         PC-FILE                   USER'S GUIDE                   Page  3.
  332.  
  333.  
  334.         GETTING STARTED.
  335.              To  start the program,  put the PC-File disk in either drive 
  336.         and enter the drive name followed by a colon:  Thus,  if the disk 
  337.         is in the right-side drive,  type "B:".  Then execute the command 
  338.         "pc-file".  An 'Autoexec.bat' file is also provided on the  disk, 
  339.         so  you can start the program by putting the disk in the  A-drive 
  340.         and   turning  on  the  power,   or  by  simultaneously  pressing 
  341.         (Ctrl)(Alt)(Del).
  342.              When prompted with the question 
  343.         "Which   drive   (ABCD)  has  the  Data:",   enter   the   letter 
  344.         corresponding  to the disk drive where your files will be stored. 
  345.         The left hand drive is "A", the right hand drive is "B".
  346.  
  347.         DEFINING YOUR FILE.
  348.              PC-File will show you a screen with the message "These files 
  349.         are already defined:", and will then ask "What File:". If this is 
  350.         the  first time you have run the program,  there will be no  file 
  351.         names  displayed.  Type in the name of the file you will want  to 
  352.         define.  This  should be a one to eight character name,  starting 
  353.         with the characters A to Z.  The only other characters allowed in 
  354.         the name are the numerals 0 to 9, but do not include a numeral as 
  355.         the  first  character in the file name.  Do not  include  a  file 
  356.         suffix (a period followed by three more characters),  because PC-
  357.         File will supply standard suffixes for your files.
  358.              You will next be prompted with "KEY FIELD NAME:".  The first 
  359.         data  field in your record is known as the "Key" field.  This  is 
  360.         the  data  which most uniquely defines the data contained in  the 
  361.         record.  For example,  'employee number' in an employee file,  or 
  362.         'part number' in an inventory.  It is not necessary for each  key 
  363.         in your file to be unique. The only significance of this field is 
  364.         that,  by  specifying it correctly,  you will be allowed somewhat 
  365.         quicker access to the data records in your file.  You will  still 
  366.         be  able  to get at all the data in the file if you specify  this 
  367.         incorrectly, so don't fret too much about it.
  368.              In  choosing a field name,  any valid character can be used. 
  369.         However,  you will find it convenient to choose relatively  short 
  370.         names,  just  long enough so you understand and can remember what 
  371.         the name stands for each time you see it.  It is best to choose a 
  372.         name that is not longer than the amount of characters actually in 
  373.         the field itself,  because the name will be truncated to the data 
  374.         length  when  printing  titles  for  your  printed  reports.  For 
  375.         example,  if an employee number is six digits long,  and you name 
  376.         the  field "EMPLOYEE",  the title for that field on  your  output 
  377.         reports  will  be "EMPLOY".  Sometimes you have to choose  longer 
  378.         names, so let your own judgement and taste be your guide. Just be 
  379.         careful  not  to use this same name for any other  field  in  the 
  380.         record.
  381.              The  name is also sensitive to whether or not you use  upper 
  382.         or  lower case letters.  If you name it with upper  case  letters 
  383.         (which  is  recommended),  then  you  will have to  refer  to  it 
  384.         subsequently   with upper case letters.  The same is true if  you 
  385.         use lower case letters in the field name.
  386.              If  the field will contain numeric data,  such as price,  or 
  387.         quantity, give the name a "#" at the end. Example: "PRICE#". This 
  388.         will cause PC-File to keep totals for that data when printing the 
  389.  
  390.  
  391.                                         3
  392.  
  393.  
  394.  
  395.  
  396.  
  397.         PC-FILE                   USER'S GUIDE                   Page  4.
  398.  
  399.  
  400.         reports,  and  will  also cause the data to  be  printed  "right-
  401.         justified" on the output reports.
  402.              Don't worry if you select an inappropriate name for a field. 
  403.         You  will be allowed to change the field names any time you  wish 
  404.         after the file has been completely defined.
  405.              You  will  now be prompted for "FIELD  LENGTH:".  Enter  the 
  406.         number  of characters which are required to contain the data  for 
  407.         that  field.  In  general,  field  lengths should be kept  to  25 
  408.         characters or less.
  409.              You will continue to be prompted for "FIELD NAME:", followed 
  410.         each time by "FIELD LENGTH:".  Continue to supply the data  until 
  411.         you have defined all the fields in your data record.  Then,  when 
  412.         prompted again with "FIELD NAME:",  simply press the (enter) key. 
  413.         Since  no  data  was entered,  PC-File will know  that  you  have 
  414.         finished with record definition.
  415.              The  maximum number of fields which you will be  allowed  to 
  416.         define is forty-one. The minimum is one.
  417.              After you have finished with record definition, PC-FIle will 
  418.         take you to the Master Menu screen.
  419.  
  420.  
  421.         THE MASTER MENU SCREEN.
  422.  
  423.              It looks like this:
  424.  
  425.  
  426.         FILE:xxxxxxx
  427.                 
  428.  
  429.                        (F1)  ADD a record
  430.                        (F2)  MODify a record
  431.                        (F3)  DELete a record
  432.                        (F4)  DISplay a record
  433.                        (F5)  FINd a record
  434.                        (F6)  LISt the records
  435.                        (F7)  SORt the index
  436.                        (F8)  see the record LAYout
  437.                        (F9)  alter a field NAMe
  438.                        (F10) END
  439.  
  440.         Your Command:___
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.                                         4
  458.  
  459.  
  460.  
  461.  
  462.  
  463.         PC-FILE                   USER'S GUIDE                   Page  5.
  464.  
  465.  
  466.              You  may  perform  any of the functions on the  master  menu 
  467.         screen by pushing the appropriate function key at the left of the 
  468.         keyboard.  You  can  accomplish the same thing by typing  in  the 
  469.         three-character function code (indicated by the three capitalized 
  470.         letters in each command). For example, to alter a field name, you 
  471.         could  either push (F9),  or you could type NAM followed  by  the 
  472.         (enter) key. Some people like function keys, some learn the names 
  473.         of  the  commands  more easily and so prefer to  type  the  three 
  474.         characters. PC-file lets you suit yourself!
  475.              Now  that  you have defined your database,  the first  thing 
  476.         that you will want to do is put some data into it.
  477.  
  478.         ADDING RECORDS TO YOUR DATABASE.
  479.              To  add  records to your file,  push (F1) or type  ADD  when 
  480.         viewing the master menu screen.
  481.              PC-file  will then find an empty spot for your new record to 
  482.         go into.  If there has been a record deleted previously from  the 
  483.         file, that location will be reused for the added record. If there 
  484.         are no deleted records in the file,  the new record will be added 
  485.         to the end of the file.  In either case, PC-File will tell you at 
  486.         the top of the screen which location it has found for adding your 
  487.         record.
  488.              You will then be promped to enter your data,  one field at a 
  489.         time.  PC-File will print out the name of the field that the data 
  490.         is to go into,  and will then prompt you to fill in the data  for 
  491.         that field.
  492.              After you have entered all the data for one record,  it will 
  493.         be added to the file. PC-File will then prompt you to add another 
  494.         record. If there are no further records to add at this time, just 
  495.         press  (enter) when asked for the data for the first field of the 
  496.         record. You will be returned to the master menu screen.
  497.              There  is a maximum of 2000 records allowed in this  version 
  498.         of  PC-File.  Depending  on  the amount of main  memory  on  your 
  499.         personal computer, you may not be able to sort the entire maximum 
  500.         of 2000 records. You will be able to enter as many records as can 
  501.         physically  fit on one diskette (even exceeding the 2000  limit), 
  502.         and  to print reports and do all the other functions provided  by 
  503.         PC-File;  but  the  amount  of  records that  can  be  sorted  is 
  504.         dependent on main memory available,  and cannot exceed 2000.  See 
  505.         the section titled "Sorting The Database" for more information on 
  506.         this topic.
  507.  
  508.         MODIFYING A RECORD.
  509.              To  modify  a record in your file,  push (F2) or type  "MOD" 
  510.         while viewing the master menu screen.  You will be asked "KEY  or 
  511.         #n,*,+,-,\ ". If you know the key (the first field in the record) 
  512.         of the record to be modified, enter it at this time.
  513.              Alternately,  you can enter the record number of the  record 
  514.         in the file.  The first record is number 1,  the second is 2, and 
  515.         so on. To modify record number 120, you would enter "#120".
  516.              Entering  an "*" will allow you to modify the most  recently 
  517.         retrieved record. This is handy when you have just used "FINd" to 
  518.         locate  a  record,  and now you are using "MODify" to change  it. 
  519.         Instead of having to enter the record # of the found record, just 
  520.         enter an "*".  It's also handy for making another modification to 
  521.  
  522.  
  523.                                         5
  524.  
  525.  
  526.  
  527.  
  528.  
  529.         PC-FILE                   USER'S GUIDE                   Page  6.
  530.  
  531.  
  532.         the same record that you just finished modifying.
  533.              A  fourth  way to specify the record to be  modified  is  to 
  534.         enter "+",  meaning to modify the next record after the one which 
  535.         you  just modified.  You can also enter a "-",  meaning to modify 
  536.         the record just prior to the one you just modified.
  537.              If  you  enter a "\",  you will be presented with  the  last 
  538.         record in the file and allowed to modify it.
  539.              PC-File  will retrieve the record to be modified and display 
  540.         one field at a time for you to either modify or leave alone.  For 
  541.         each field,  you will be asked to "Press 'M' to modify,  or press 
  542.         (enter)".  If you press (enter), the field will remain unchanged. 
  543.         If you press "M",  you will then be promped to enter the new data 
  544.         for that field.
  545.              After  you  have  modified the entire record,  you  will  be 
  546.         prompted  to  enter  the  KEY value  for  another  record  to  be 
  547.         modified.  If  you  have no other modifications to make  at  this 
  548.         time,  just  press (enter) and you will be returned to the master 
  549.         menu screen.
  550.  
  551.         DELETING A RECORD.
  552.              To  delete a record,  press (F3) or type "DEL" while viewing 
  553.         the master menu screen.  You will be asked  "KEY or #n,*,+,-,\ ". 
  554.         You  should  then enter the Key value of the first field  in  the 
  555.         record to be modified, or the record number in the file (preceded 
  556.         by a #),  or an "*" to delete the most recently retrieved record, 
  557.         or  a  "+"  to delete the next record in sequence,  or a  "-"  to 
  558.         delete  the previous record in sequence,  or a "\" to delete  the 
  559.         last  record in the file.  (Read the above section  "Modifying  A 
  560.         Record" for a longer explanation of this prompt.)
  561.              PC-File  will retrieve the record and display it for you and 
  562.         then ask you to "Type 'DELETE',  or press (enter)". If you decide 
  563.         that you really do wish to delete the record,  type "DELETE"  and 
  564.         press  (enter).  If  you decide not to delete this  record,  just 
  565.         press (enter).  You will then be prompted for the next record KEY 
  566.         to  be deleted.
  567.              When  you have finished with all your deletions,  just press 
  568.         (enter) when asked for the next record KEY.  You will be returned 
  569.         to the master menu.
  570.  
  571.         DISPLAYING A RECORD (by using the 'KEY').
  572.              To display a record,  press (F4) or type "DIS" while viewing 
  573.         the master menu screen.  You will be asked "KEY,  or #n,+,-,\  ". 
  574.         You  should  then enter the Key value of the first field  in  the 
  575.         record  to  be  displayed,  or  the record  number  in  the  file 
  576.         (preceded  by  a  #),  or  a "+" to display the  next  record  in 
  577.         sequence, or a "-" to display the previous record in sequence, or 
  578.         a  "\"  to  display the last record in  the  file.  PC-File  will 
  579.         retrieve and display the record for you,  and then prompt you for 
  580.         the next record to be displayed.  When you are through displaying 
  581.         records,  just  press  (enter) and you will be  returned  to  the 
  582.         master menu screen.
  583.  
  584.         FINDING A RECORD.
  585.  
  586.              To find a record, press (F5) or type "FIN" while viewing the 
  587.  
  588.  
  589.                                         6
  590.  
  591.  
  592.  
  593.  
  594.  
  595.         PC-FILE                   USER'S GUIDE                   Page  7.
  596.  
  597.  
  598.         master  menu  screen.  You will then be shown a list of  all  the 
  599.         field  names in the database,  and asked "FIELD TO  SEARCH".  You 
  600.         should type in the name of the field which you wish to search on. 
  601.         Be  sure  to  type the field name exactly as  it  was  originally 
  602.         entered (watch out for upper and lower case characters).  PC-File 
  603.         will next prompt you with:
  604.              '>xxx' scans full field. (slow)
  605.              Look for:__________
  606.         You  should  now type in the data which you would like to  search 
  607.         for.  If you precede the data with a ">" character,  PC-File will 
  608.         look  for an occurrence of that data anywhere in the  field.  For 
  609.         example,  if you type ">mit", records will be returned which have 
  610.         "Smith",  or  "transmit",  or "miter",  etc.  If you  type  "mit" 
  611.         (without  the ">" in front) records will be retrieved which start 
  612.         out "mit" in the field, such as "miter", "mitten", etc.
  613.              The  second type of search will proceed considerably  faster 
  614.         than the first type,  because to do a "full field scan",  PC-File 
  615.         must look at every record in the file.  To do the second type  of 
  616.         search,  PC-File  can  take advantage of its index file for  very 
  617.         rapid retrieval.
  618.              Note  that  the  search is fully  "generic":  that  is,  all 
  619.         records  will be retrieved when the data field "begins with"  the 
  620.         search data.  You can,  for example,  find all records with  last 
  621.         names  that  start with "S",  or find all records with zip  codes 
  622.         starting with "980".
  623.              Each  record  found  will  be  displayed  in  its  entirety, 
  624.         followed by this prompt:  "S to stop,  or press (enter)".  If you 
  625.         want to find more records which match this search criteria,  just 
  626.         press (enter).  The next record will be found and  displayed.  If 
  627.         you wish to stop searching for this data,  thpe "S" and then push 
  628.         (enter).
  629.  
  630.         LISTING THE RECORDS.
  631.              The  listing  capabilities  of  PC-File  are  very  powerful 
  632.         indeed.  You will be allowed to search for data based on "equal", 
  633.         "unequal", "greater than", or "less than" relationships. The data 
  634.         can  be  displayed in any format which you specify.  And you  can 
  635.         list the report on your printer or on your video screen.
  636.              To list the records,  press (F6) or type "LIS" while viewing 
  637.         the  master menu screen.  You will be shown the names of all  the 
  638.         report  formats which you have previously defined to the  system, 
  639.         and asked "Which format, or press (enter)".
  640.              If  this  is  the  first  time  you've  ever  created   this 
  641.         particular  report format,  just press (enter).  You will then be 
  642.         shown all of the field names in this database, and prompted with:
  643.         "Column=0.  Field to List:". You should type in (watching out for 
  644.         upper and lower case) the name of the field which you would  like 
  645.         to see first on your report (at the far left). As you continue to 
  646.         be prompted to enter field names, PC-File will keep you informed, 
  647.         at  the bottom of the screen,  about the number of print  columns 
  648.         which you have used up. If the report will go to your screen, you 
  649.         should not let this number go beyond 80. If the report will go to 
  650.         your printer, you should not let the number go beyond the maximum 
  651.         width of a print line.
  652.              If  you are defining a "Labels" listing,  you should enter a 
  653.  
  654.  
  655.                                         7
  656.  
  657.  
  658.  
  659.  
  660.  
  661.         PC-FILE                   USER'S GUIDE                   Page  8.
  662.  
  663.  
  664.         "/"  instead of a field name at the times when you would  want  a 
  665.         carriage-return/line feed to occur.  In this case, you must cause 
  666.         at  least  one blank line to appear between each label (a "/"  as 
  667.         the only field defined on the last line of the report).
  668.              When  you  have entered all of the fields to appear  on  the 
  669.         listing,  just push (enter).  You will be asked "Save this report 
  670.         format?".  Reply  "Y" if you will ever want to print this  report 
  671.         again,  or "N" if this is a one-time-only report.  If you replied 
  672.         "Y", you will then be asked "Name for this format:". Just type in 
  673.         a 1 to 8 character name by which you would like to remember  this 
  674.         report format.
  675.              You will next be asked "List on Printer or Screen (P or S)". 
  676.         Type "P" to get a printed list, or "S" to get the listing on your 
  677.         video screen.
  678.              If  this is not a labels list,  you will be asked "Title  of 
  679.         Report:". Enter any title up to 39 characters long.
  680.              You will then be asked "List All records or Selected records 
  681.         (A  or S):".  If you want to see all the records in your  report, 
  682.         answer "A".
  683.              If you only want to list some of the records, answer "S". In 
  684.         this  case,  you  will be shown all of the field names and  asked 
  685.         "Field  to Select on:".  PC-File wants to know which  field  will 
  686.         determine  whether or not the record will be printed.  Enter  the 
  687.         field name (watching out for upper and lower case). You will then 
  688.         be  asked  "Compare how?   >,<,=,<> ".  The field which you  have 
  689.         selected will later be compared to some value which you will also 
  690.         later enter. PC-File is asking how it should compare the field to 
  691.         the value.  If you will want them to be equal,  enter "=". If you 
  692.         will  want  to see records which have the field  less  than  some 
  693.         value, enter "<". For a "greater than" comparison, enter ">". For 
  694.         "unequal",  enter "<>". Now you will be asked for the value which 
  695.         your  field  will  be compared to.  PC-File  asks:  "Compared  to 
  696.         value:". Enter the value.
  697.         Example: To list all records with zip codes greater than "980",
  698.         you would respond as follows:
  699.         "Field to select on:"         ZIPCODE
  700.         "Compare how?       "         >
  701.         "Compared to value: "         980
  702.              If  you  are using a printer for output,  PC-File  will  now 
  703.         pause with a message to allow you to set up the printer.
  704.              Now  is when PC-File really goes to work for you.  Here's  a 
  705.         peek at what's going on behind the scene:
  706.              PC-File  will  select or reject each record  based  on  your 
  707.         selection  criteria.  It  will automatically print  your  titles, 
  708.         column headings,  and page numbers for a report, or omit them for 
  709.         labels. It will automatically format your output list, sending it 
  710.         to  the  screen  or  printer,  pausing the screen  at  the  right 
  711.         moments. For labels, it automatically compresses the output lines 
  712.         and data to make nice looking labels. It accumulates final totals 
  713.         for all field names ending with a "#".
  714.              To stop the listing and abort it early,  you may press (Esc) 
  715.         at any point in time.
  716.  
  717.         SORTING THE DATABASE INDEX.
  718.              You  can  cause  your records to be placed  in  a  different 
  719.  
  720.  
  721.                                         8
  722.  
  723.  
  724.  
  725.  
  726.  
  727.         PC-FILE                   USER'S GUIDE                   Page  9.
  728.  
  729.  
  730.         sequence by using the sort feature.
  731.              To sort the records,  press (F7) or type "SOR" while viewing 
  732.         the master menu screen.  PC-File will load a special sort program 
  733.         into the computer,  print out all the field names, and ask: "Sort 
  734.         field  #1:".  You  should enter the name of the field  which  you 
  735.         would  like  to use to sequence the file.  If the  sequence  will 
  736.         depend  on multiple fields,  you should give the name of the most 
  737.         primary field in the sort sequence.  You will be allowed to enter 
  738.         up to ten field names in the sort sequence.
  739.              After each field name,  you will be shown the length of  the 
  740.         field  and asked "Length?".  Sometimes you don't have to sort  on 
  741.         the  full  length  of  the field,  and the sort  would  run  more 
  742.         effeciently in these cases.  For example,  to sort on a last-name 
  743.         field that is 15 characters long, it may be sufficient to sort on 
  744.         only  the first 6 or 7 characters.  You be the judge.  Enter  any 
  745.         number from 1 to the full length of the field.
  746.              When you have finished identifying all the sequence  fields, 
  747.         just push (enter).
  748.              You  will then be asked "Ascending or Descending (A or D):". 
  749.         This  is  your  chance to tell whether you want the  file  to  be 
  750.         sorted  into  ascending or descending sequence based on the  sort 
  751.         fields that you specified.
  752.              The  sort  will  now proceed and keep you  informed  of  its 
  753.         status as it progresses.
  754.              During  the main part of the sort,  you will see the message 
  755.         "Sorting xxx Records" and a number appearing centered under  that 
  756.         line.  The number will decrease by 1 each time it changes, from 5 
  757.         down to 1.  This is an attempt to give you a feeling for how long 
  758.         the sort will take.  When the number reaches zero, the sort phase 
  759.         is complete.
  760.              At  the  start  of the sort phase and of the  index  rebuild 
  761.         phase, you will see an estimate of how long that particular phase 
  762.         will  take.  During the index rebuild,  the countdown from 5 to 1 
  763.         may appear several times, because the rebuild phase reinvokes the 
  764.         sort routine once for each 500 records in the file.  I think that 
  765.         you'll be pleasantly surprised by the speed of the sort.
  766.              When the sort is finished,  it will reload the main  program 
  767.         and take you back to the starting point of PC-File. 
  768.              A technical note for those who are so inclined:  The sort is 
  769.         a "Shell" sort and takes place entirely in main memory.  The data 
  770.         file  itself  is  not sorted.  The  Index  file,  which  contains 
  771.         pointers to the data records,  is sorted. This permits very large 
  772.         files  to  be sorted at high speed.  The sort  program  has  been 
  773.         defined with a maximum of 2000 records to be sorted.  This number 
  774.         is  an  entirely arbitrary guess,  and may be changed  in  future 
  775.         releases  of PC-File as more experience is gained with  computers 
  776.         of various memory sizes. If you ever run out of memory during the 
  777.         sort, try sorting with a smaller number and size of sort fields.
  778.  
  779.         SEEING THE RECORD LAYOUT.
  780.              To see the record layout as it was originally defined, press 
  781.         (F8) or type "LAY" while viewing the master menu screen. You will 
  782.         be  shown a list of all the field names defined for  the  record, 
  783.         along  with  the  corresponding length defined  for  each  field. 
  784.         Pressing (enter) will then return you to the menu screen.
  785.  
  786.  
  787.                                         9
  788.  
  789.  
  790.  
  791.  
  792.  
  793.         PC-FILE                   USER'S GUIDE                   Page  10.
  794.  
  795.  
  796.  
  797.         ALTERING A FIELD NAME.
  798.              You  can  change  the  name of any  field  defined  in  your 
  799.         database.  You might want to do this,  for example,  to change  a 
  800.         field  from numeric to character,  or to shorten the field  name. 
  801.         Press (F9) or type "NAM" while viewing the master menu screen.
  802.              You  will  be shown a list of all the field names and  asked 
  803.         "Which Name to Change:".  Type the name of the field you wish  to 
  804.         change  (watch out for upper/lower case).  You will then be asked 
  805.         to  "Enter the New Name:".  Type the name that you would like  to 
  806.         use  for the new name of the field.  You will then be allowed  to 
  807.         change the name of another field, or just press (enter) to return 
  808.         to the master menu screen.
  809.  
  810.         ENDING THE PROGRAM.
  811.              To  end the program and return to the DOS operating  system, 
  812.         press  (F10) or type "END" while viewing the master menu  screen. 
  813.         PC-File  will  ask  "Quit?",  just to make sure  you're  serious. 
  814.         Answer "Y" if you are, "N" if you're not.
  815.  
  816.         BACKING UP THE DATABASE.
  817.              From time to time,  it is a good idea to make a backup  copy 
  818.         of  an  important  database.  In order to back  up  your  PC-File 
  819.         database,  you  will  need to get into the DOS operating  system. 
  820.         Then,  assuming that your data disk is in the B:  drive, and that 
  821.         your disk which will receive the backup copy is in the A:  drive, 
  822.         the following two commands will make a backup copy for you.
  823.  
  824.              COPY B:filename.*   A:
  825.              COPY B:*.RPT        A:
  826.  
  827.         (where  "filename"  is the name that you used for  your  database 
  828.         file.). This will copy the following files for you:
  829.         filename.HDR
  830.         filename.INX
  831.         filename.DTA
  832.         and all ".RPT" (report) files which you have defined on the disk.
  833.  
  834.         USING OTHER PRINTERS.
  835.              PC-File  is distributed for use with the IBM Printer or with 
  836.         the  Epson MX-80.  However,  it is possible to use  PC-File  with 
  837.         other printer types. 
  838.              When  the PC-File program starts up,  it opens a file called 
  839.         "PRT.CTL",  which  contains  control characters for  causing  the 
  840.         printer  to print either condensed characters (132 characters per 
  841.         line)  or normal sized characters (80 characters per  line).  You 
  842.         can  change  these  characters to  anything  that  you  like,  to 
  843.         override the defaults which have been established.  You will need 
  844.         to  use  a text editor program,  or the EDLIN program that  comes 
  845.         with your system. The default PRT.CTL file looks like this:
  846.          /80,18,/132,15
  847.         The  /80 starts the definition of control characters to cause the 
  848.         printer  to  print  "normal" width.  the  ",18"  is  the  decimal 
  849.         representation  of the necessary control character.  Replace this 
  850.         with whatever is necessary for your printer.  If multiple control 
  851.  
  852.  
  853.                                        10
  854.  
  855.  
  856.  
  857.  
  858.  
  859.         PC-FILE                   USER'S GUIDE                   Page  11.
  860.  
  861.  
  862.         characters  are required,  enter as many as necessary,  each  one 
  863.         separated by a comma. The "/132" starts the definition of control 
  864.         characters to cause the printer to print "condensed"  characters. 
  865.         The  ",15" is the decimal representation of the necessary control 
  866.         character.
  867.              One  possible  example of a change you would want  to  make, 
  868.         would be for a daisy wheel printer that always prints 132 columns 
  869.         wide,  in  which case you wouldn't need any control characters at 
  870.         all. The PRT.CTL  for this example should be set up as follows:
  871.          /80,/132
  872.         (no control characters used.)
  873.  
  874.         USING 40-CHARACTER WIDTH DISPLAYS.
  875.              If  you  have a video display which only allows  viewing  in 
  876.         "40-column" mode,  such as a television set with an RF Modulator, 
  877.         you  can  change  the file named "PRT.CTL" to  cause  PC-File  to 
  878.         handle  this situation.  If you are using an IBM printer  or  the 
  879.         Epson  MX-80  printer,  the easiest way to do this is to  copy  a 
  880.         standard  file  which  has already been provided  on  your  disk, 
  881.         overlaying the old copy of PRT.CTL. While running under DOS, just 
  882.         enter the command:
  883.              COPY PRT40.CTL PRT.CTL
  884.         This  will  cause the file named PRT.CTL to be overlayed  with  a 
  885.         copy  of the file named PRT40.CTL.  You will now run in 40 column 
  886.         mode whenever you use PC-File.  If you ever wish to go back to 80 
  887.         column mode, just copy the file named PRT80.CTL to PRT.CTL.
  888.              If  you need to use 40-column mode,  and also have a  unique 
  889.         printer,  you  will  need to read the above topic  titled  "Using 
  890.         Other Printers".  While creating the PRT.CTL file as described in 
  891.         that section,  also include the characters "/40" (separated  from 
  892.         the other data by commas), in your file.
  893.  
  894.         USING THE PC-FILE DATA WITH OTHER PROGRAMS.
  895.              PC-File  makes  an excellent "Front End" program  for  other 
  896.         systems  which you might develop.  You can use PC-File to  handle 
  897.         the file maintenance functions,  and concentrate your efforts  on 
  898.         the rest of the system.
  899.              The  file  "filename.DTA" (where "filename" is the name  you 
  900.         gave the database),  is the data file which you will want to use. 
  901.         The file is laid out just as you would want it to be,  with  each 
  902.         field  of  the  record being fixed length (the  length  that  you 
  903.         defined for it) and padded on the right if necessary with blanks. 
  904.         The  fields  are  in the record in the same order  in  which  you 
  905.         defined them.  Deleted records which have not been re-used,  will 
  906.         be  totally  filled with the "/" (slash) character.  There  is  a 
  907.         carriage  return  character  (HEX 0D) added to the  end  of  each 
  908.         record.  This  is put there to make it easier for you to  process 
  909.         this data with any programming language available. The end of the 
  910.         file  is marked with a "\" (backslash) in the far  left  position 
  911.         (Byte  1).  All records in the file will be the same length.  The 
  912.         sequence of the records in the file is the same sequence in which 
  913.         they were originally entered (ADDed), except that deleted records 
  914.         are re-used when another ADD takes place.  The sort program  does 
  915.         not resequence the data portion of the database, only the index.
  916.  
  917.  
  918.  
  919.                                        11
  920.  
  921.  
  922.  
  923.  
  924.  
  925.         PC-FILE                   USER'S GUIDE                   Page  12.
  926.  
  927.  
  928.         IMPORTING OTHER FILES INTO PC-FILE.
  929.              It  is  possible  to  use files created  on  other  systems, 
  930.         defining them to PC-File as your own database.  To do  this:
  931.         1. Start up  PC-File and define the file as a new file on  your 
  932.              system, so that the "filename.HDR" file will be established.
  933.         2. Erase "filename.DTA" from your PC-File data disk (it should be 
  934.              empty anyway at this point.)
  935.         3. Copy your file  to be converted,  onto your PC-File data disk, 
  936.              giving it the name "filename.DTA".
  937.         4. Your file must be in fixed-length record format, and contain a 
  938.              "\" (backslash) as the first character in the last record of 
  939.         the  file.  You may have to use a special program,  or an  editor 
  940.         program  to get your file into this format.  The following  short 
  941.         basic program will put the '\' there if you care to use it:
  942.              10 INPUT "Enter the filename:",F$
  943.              20 OPEN F$ FOR APPEND AS #1
  944.              30 PRINT#1,STRING$(254,"\")
  945.              40 CLOSE
  946.         5.  Now you have everything that you need except  "filename.INX". 
  947.              Start up PC-File again, specifying your filename as the file 
  948.         you'll be working with.  Select the "SORT" option,  and sort your 
  949.         file  in  whatever sequence you desire.  Since the  sort  program 
  950.         builds  a fresh index from scratch whenever it is run,  you  will 
  951.         have  a complete database going for you after you  have  finished 
  952.         the sort.
  953.  
  954.         COMPATIBILITY WITH PRIOR VERSIONS.
  955.              PC-File  is an enhancement to a previous program by the same 
  956.         author entitled "EasyFile".  One of the improvements is that  the 
  957.         index now takes two fewer characters per record. Therefore, users 
  958.         of  the old EasyFile program will have to cause a new index to be 
  959.         built  on their database.  This can be done by invoking the  Sort 
  960.         immediately after starting up PC-File.  The sort will build a new 
  961.         index,  and  then the old files will be 100% compatible with  all 
  962.         versions of PC-File. 
  963.  
  964.         SOME MAXIMUMS AND MINIMUMS.
  965.              Minimum RAM Memory required..............................64K
  966.              Minimum Disk Drives required...............................1
  967.              Maximum Disk Drives supported..............................4
  968.                   (Drives A through D, but all the programs must be on
  969.                    one drive, and all the data must be on one drive.)
  970.              Maximum Field length......................................25
  971.              Minimum Field length.......................................1
  972.              Maximum Field Name length.................................12
  973.              Minimum Field Name length..................................1
  974.              Maximum Fields per Database (80 char. display)............41
  975.              Maximum Fields per Database (40 char. display)............21
  976.              Maximum Records per Database............................2000
  977.                   (more, if you don't need to sort, up to maximum 
  978.                    capacity of the disk)
  979.              Maximum Number of Sort Control Fields.....................10
  980.  
  981.         CALCULATING THE SIZE OF DATABASE DISK STORAGE.
  982.              You  can  quickly calculate the amount of  disk  space  your 
  983.  
  984.  
  985.                                        12
  986.  
  987.  
  988.  
  989.  
  990.  
  991.         PC-FILE                   USER'S GUIDE                   Page  13.
  992.  
  993.  
  994.         database will consume. For the filename.INX file, take the number 
  995.         of fields defined and multiply this by 2.  To that answer, add 4. 
  996.         The  answer is the number of characters in an index  record.  For 
  997.         the  filename.DTA  file,  add together the length of  each  field 
  998.         defined.  To  that  answer,  add  1.  This gives  the  number  of 
  999.         characters  in a data record.  If you add together the calculated 
  1000.         length  of  the INX record and the length of the DTA  record  and 
  1001.         multiply this by the maximum number of records you expect to have 
  1002.         in your database, you will have the total number of characters of 
  1003.         disk space required to contain your database.
  1004.  
  1005.         A NOTE FOR USERS WITH ONLY 1 DISK DRIVE.
  1006.              You  will probably want to create a "Production" version  of 
  1007.         PC-File,  to  give yourself the maximum amount of available  disk 
  1008.         space.  To  do this,  Make a copy of the PC-File diskette,  which 
  1009.         will become your production copy.  Then, on this copy, delete all 
  1010.         files except PC-FILE.EXE,  PC-SORT.EXE, PRT.CTL, and COMMAND.COM. 
  1011.         This  will  leave you with about 87000 characters  of  free  disk 
  1012.         storage  space.  This is enough to store about 700 records in  an 
  1013.         "average"   database.   Review   the   section   above   entitled 
  1014.         "Calculating the Size of Database Disk Storage.
  1015.  
  1016.         DISCLAIMER.
  1017.              In  no  event  will  the Author be liable  to  you  for  any 
  1018.         damages,  including  any  lost profits,  lost  savings  or  other 
  1019.         incidental  or consequential damages arising out of the use of or 
  1020.         inability  to  use these programs,  even if the Author  has  been 
  1021.         advised of the possibility of such damages,  or for any claim  by 
  1022.         any other party.
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.                                        13
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057. any other party.
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.                                        13
  1087.  
  1088.  
  1089.  
  1090.  
  1091.